@microsoft/applicationinsights-core-js

What is @microsoft/applicationinsights-core-js?

@microsoft/applicationinsights-core-js is a core library for Application Insights, which is a part of the Azure Monitor suite. It provides the essential functionalities for collecting and sending telemetry data from your applications to Azure Monitor. This package is typically used as a base for other Application Insights SDKs and can be extended to include additional telemetry features.

What are @microsoft/applicationinsights-core-js's main functionalities?

Initialization

This code demonstrates how to initialize the Application Insights core library with a given instrumentation key. This is the first step to start collecting telemetry data.

const { ApplicationInsights } = require('@microsoft/applicationinsights-core-js');
const appInsights = new ApplicationInsights({ config: {
  instrumentationKey: 'YOUR_INSTRUMENTATION_KEY'
}});
appInsights.loadAppInsights();

Custom Events

This code shows how to track custom events. Custom events can be used to log specific actions or occurrences in your application.

appInsights.trackEvent({ name: 'myCustomEvent', properties: { customProperty: 'customValue' } });

Custom Metrics

This code demonstrates how to track custom metrics. Custom metrics can be used to log numerical data points that are important for your application.

appInsights.trackMetric({ name: 'myCustomMetric', average: 42 });

Exception Tracking

This code shows how to track exceptions. Exception tracking is useful for logging errors and understanding the issues occurring in your application.

try {
  throw new Error('Test error');
} catch (e) {
  appInsights.trackException({ exception: e });
}

Other packages similar to @microsoft/applicationinsights-core-js

newrelic

New Relic is a comprehensive monitoring and observability platform. It offers similar functionalities to Application Insights, such as custom event tracking, metrics, and error logging. However, New Relic provides a broader range of integrations and more advanced analytics features.

datadog

Datadog is another monitoring and analytics platform that provides similar functionalities, including custom event tracking, metrics, and error logging. Datadog is known for its extensive integrations and real-time monitoring capabilities.

sentry

Sentry is a popular error tracking and performance monitoring tool. It focuses more on error tracking and performance monitoring compared to Application Insights, which offers a broader range of telemetry data collection.

README

Microsoft Application Insights JavaScript SDK - Core

Core SDK layer for next version of application insights javascript SDK.

Build:

• Install: $ npm install
• amd: $ grunt core
• cjs: $ grunt corecjs

Run unit tests:

• $ grunt coretest

Publish a new npm package (publish cjs first then amd)

cjs

1. $ grunt corecjs
2. Please ensure unit tests pass
3. $ cd cjs
4. Update version in package.json (version number even for cjs)
5. $ npm pack
6. $ npm publish --tag cjs

amd

1. $ grunt core
2. Please ensure unit tests pass
3. $ cd amd
4. Update version in package.json (version number odd for amd)
5. $ npm pack
6. $ npm publish --tag amd

Publish a new nuget package, follow the steps below:

1. Go to VSTS Packages
2. Click "connect to feed". Select NuGet.
3. Follow the instructions for installing the tools and adding the feed.
4. Follow the instructions below to push cjs and amd nuget packages. (publish cjs first then amd)

cjs

1. $ grunt corecjs
2. Please ensure unit tests pass
3. $ cd cjs
4. Update version in applicationinsights-core-js.nuspec (version number even for cjs)
5. $ nuget pack
6. $ nuget.exe push -Source "ApplicationInsights-Team" -ApiKey VSTS <Nuget Package Name>.nupkg

amd

1. $ grunt core
2. Please ensure unit tests pass
3. $ cd amd
4. Update version in applicationinsights-core-js.nuspec (version number odd for amd)
5. $ nuget pack
6. $ nuget.exe push -Source "ApplicationInsights-Team" -ApiKey VSTS <Nuget Package Name>.nupkg

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.

License

MIT